.. _`поиск документооборотов`: https://developer.kontur.ru/doc/extern.docflows/method?type=get&path=%2Fv1%2F%7BaccountId%7D%2Fdocflows .. _`POST Recognize`: https://developer.kontur.ru/doc/extern.docflows/method?type=post&path=%2Fv1%2F%7BaccountId%7D%2Fdocflows%2F%7BdocflowId%7D%2Fdocuments%2F%7BdocumentId%7D%2Frecognize .. _`Send`: https://developer.kontur.ru/doc/extern/method?type=post&path=%2Fv1%2F%7BaccountId%7D%2Fdrafts%2F%7BdraftId%7D%2Fsend .. _`сервис контентов`: https://developer.kontur.ru/doc/extern/method?type=post&path=%2Fv1%2F%7BaccountId%7D%2Fcontents .. _`POST SignPfrReplyDocument`: https://developer.kontur.ru/doc/extern.docflows/method?type=post&path=%2Fv1%2F%7BaccountId%7D%2Fdocflows%2F%7BdocflowId%7D%2Fdocuments%2F%7BdocumentId%7D%2Fpfr-replies%2F%7BreplyId%7D%2Fcloud-sign .. _`GET DocflowPfrReplyDocumentTask`: https://developer.kontur.ru/doc/extern.docflows/method?type=get&path=%2Fv1%2F%7BaccountId%7D%2Fdocflows%2F%7BdocflowId%7D%2Fdocuments%2F%7BdocumentId%7D%2Fpfr-replies%2F%7BreplyId%7D%2Ftasks%2F%7BapiTaskId%7D .. _`POST SignConfirmPfrReplyDocument`: https://developer.kontur.ru/doc/extern.docflows/method?type=post&path=%2Fv1%2F%7BaccountId%7D%2Fdocflows%2F%7BdocflowId%7D%2Fdocuments%2F%7BdocumentId%7D%2Fpfr-replies%2F%7BreplyId%7D%2Fcloud-sign-confirm .. _`метод для генерации входящих писем Росстат`: https://developer.kontur.ru/doc/extern.test.tools/method?type=post&path=%2Ftest-tools%2Fv1%2Fgenerate-incoming-stat-letter История изменений API ===================== Апрель 2023 ----------- * Добавили методы для просмотра :doc:`реквизитов плательщика` и пользователей :doc:`многопользовательского режима`. * Поддержали работу с :ref:`новым документооборотов в СФР`. Январь 2023 ----------- * Поддержали :doc:`работу` с новыми документооборотами СЭДО: - требования ФСС (urn:docflow:fss-sedo-demand); - ответ на требование ФСС (urn:docflow:fss-sedo-demand-reply); - результат ответа на требование ФСС (urn:docflow:fss-sedo-demand-reply-result); - запрос на формирование справки о расчетах ФСС (urn:docflow:fss-sedo-billing-information-demand); - результат обработки запроса справки о расчетах ФСС (urn:docflow:fss-sedo-billing-information-demand-result); - справка о расчетах ФСС (urn:docflow:fss-sedo-billing-information); - уведомление о прекращении отпуска по уходу за ребенком до полутора лет (urn:docflow:fss-sedo-baby-care-vacation-close-notice). Сентябрь 2022 ------------- * Добавили :doc:`возможность` передавать созданные в API черновики в веб-интерфейс Контур.Экстерна. Июль 2022 --------- * Поддержали работу с :doc:`машиночитаемой доверенностью в ФСС`. Алгоритм работы в API смотрите в :doc:`статье`. Июнь 2022 --------- * Поддержали в методе :ref:`Получение списка документооборотов` поиск документооборотов описи urn:docflow:fns534-inventory через фильтр ``type``. Май 2022 -------- * Сделали обязательным :ref:`асинхронное выполнение запросов` для методов: * :ref:`проверки`, :ref:`подготовки`, :ref:`отправки` черновика; * :ref:`печати документа в черновике`; * :ref:`печати документа в документообороте`; * :ref:`сборки DraftsBuilder в черновик`. Апрель 2022 ----------- * Добавили новый тип DraftsBuilder для работы с :doc:`письмами ФНС` в конструкторе черновиков. Январь 2022 ----------- * Поддержали сценарий работы с :doc:`Проактивными выплатами`. Ноябрь 2021 ----------- * В метаинформации документооборота 4-ФСС (модель FssReportRequisites) добавили новое поле ``sender-certificate-thumbprint``. Поле возвращает отпечаток сертификата, которым был подписан отчет. * В метаинформации документооборота требований (модель DemandAttachmentRequisites) добавили новые поля: * ``tax-department-name`` — наименование налогового органа; * ``tax-event-name`` — наименование мероприятия налогового контроля. **Обновление в Extern Test Tools:** * Добавили `метод для генерации входящих писем Росстат`_. Октябрь 2021 ------------ * Исправлены ошибки по определению признаков зашифрованности ``encrypted`` и сжатости ``compressed`` контента для документов ПФР. Август 2021 ----------- * Поддержали в :doc:`методах формирования файлов` генерацию новой версии УСН по новому контракту. В разделе Справка добавлен :doc:`файл новой версии контракта` для формирования файла версии 5.06 для отчётности с 2021 года. * В методах по работе с документооборотом в API добавлен новый метод :ref:`Сохранения расшифрованного контента в документ`. Март 2021 --------- * Исправлена ошибка 500, которая появлялась при попытке печати приложений в письмах от ПФР в формате ods/excel. Теперь API возвращает ошибку 400 PrintUnsupported. * Для поручений, которые приходят вместе с требованиями от ФНС, добавлена возможность распознавания корректного КНД из файла. Чтобы отличить поручение от требования добавлено новое поле ``demand_knd`` (модели DemandAttachmentRequisites и RecognizedMeta), в котором будет лежать КНД поручения. Чтобы поле заполнилось нужно вызвать метод :ref:`Распознавания требования`. Февраль 2021 ------------ * Новый документооборот для отправки писем в Росстат, подробнее в статье :doc:`Отправка писем в Росстат`. * В метаинформации документоооборота письма в ФНС (модель LetterDescription) добавлено новое поле ``sender-inn``. * В метаинформации документоооборота письма из ФНС (модель CuLetterDescription) добавлено новое поле ``recipient-inn``. Декабрь 2020 ------------ * В документации появилась новая :doc:`cтатья по криптографии`. * Исправлена ошибка при отправке Заявления на подключение к ЭДОК. * В методе распознавания требования добавлена проверка, что файл требования в формате pdf. * В метаинформации документооборота требования (модель DemandDescription) добавлено новое поле ``sent-on-report-filename`` — имя файла отчета, на которое сформировано требование. * В метаинформации документооборота 4-ФСС (модель FssReportDescription) добавлено новое поле ``correction-number`` — номер корректировки. **Обновления в Extern Test Tools:** * Поддержан новый способ :doc:`аутентификации по протоколу OpenId Connect `. Рекомендуется выполнять запросы при помощи Postman. Старый способ аутентификации через auth.sid будет поддерживаться для реализованных интеграций. Ноябрь 2020 ----------- * Для устаревших методов по получению зашифрованного и расшифрованного контента введены ограничения на размер запрашиваемого контента: 32 МБ на тестовой и 64 МБ на рабочей площадке. Для получения больших контентов вместо старых методов рекомендуется использовать Сервис контентов. * В свойствах документа документа в документообороте реализован новый вспомогательный параметр SupportPrint (модель DocflowDocumentDescription), который поможет определить возможность печати документа. Параметр может иметь одно из трех значений: Yes, No, Unknown. Подробнее в статье :doc:`Печать `. Октябрь 2020 ------------- Новый способ :doc:`аутентификации по протоколу OpenId Connect `. Старый способ аутентификации через auth.sid будет поддерживаться для реализованных интеграций. Сентябрь 2020 ------------- * Новый вид :ref:`документооборота с ЦБ РФ`. Доступен только для получения списка документооборотов. Отправить документы в ЦБ РФ можно в веб-интерфейсе Экстерна. * API теперь поддерживает новые формы заявления регистрации бизнеса. Полный список кодов заявлений описан в методе :ref:`Создания DraftsBuilder` (параметр application-code). **Обновления в Extern Test Tools:** * Исправлена ошибка экранирования кавычек, из-за которой в некоторых случаях могло некорректно сформироваться входящее требование. Август 2020 ----------- * В методах API добавлен **новый метод проверки требований**. Метод помогает определить корректность поступившего требования. Если требование не прошло проверки, будут сформированы коды ошибок, которые нужно использовать при формировании уведомления об отказе. Подробнее в инструкции :doc:`Проверка требований`. * Настроено корректное отображение размера расшифрованного контента документа в поле decrypted-content-size. * Исправлена ошибка печати документов из документооборота ПОВЭД: в печатной форме отчета корректно проставляется дата отчета и наименование организации. Июнь 2020 --------- * В методах API добавлена возможность формирования подписи xmlDsig для подписания :doc:`отчета СЗВ-ТД и заявления на подключение к ЭДОК в ПФР`. Подробное описание в документации: :doc:`Подпись XMLDsig для отчетов в ПФР`. Май 2020 -------- * Добавили в :doc:`методы формирования файлов` в черновике возможность генерации заявления на подключение к ЭДОК. Достаточно передать валидный JSON контракт, метод сгенерирует контент файла и положит его в документ черновика. * О штампах в печатных формах: * Внесли правки в печати штампов на отчетах. * Добавили в штампы помимо названия инспекции ее код. * Добавили штампы в печатные формы отчета 2-НДФЛ. * В печатных формах добавили указание общего количества страниц. * В документации добавили новый раздел :doc:`Начало работы с API`. Апрель 2020 ----------- * Доработали `поиск документооборотов`_: теперь можно запрашивать сразу несколько типов в параметре type. Например, type=fns534-report&type=pfr-report. * Новый вид отчетности в ПФР: отправка отчета СЗВ-ТД и готового заявления на подключение к ЭДОК. * Добавили в description документооборота ИНН-КПП реорганизованных и ликвидированных организаций, которые лежат внутри отчетов по таким организациям. * В рамках :doc:`документооборота регистрации бизнеса` реализовали регистрацию ЮЛ, отправку документов на ликвидацию ИП. Март 2020 --------- * Добавили возможность асинхронной печати документов, теперь можно ставить задачи на печать (Tasks). * Исправили появление дублей в документообороте Росстата. * Добавили ссылки в документообороте 4-ФСС, которые ведут в веб-интерфейс Экстерна. * Добавили проверку сертификата подписи при отправке ответных документов ФНС: ИНН в сертификате подписи должен быть равен ИНН в поле Sender. Февраль 2020 ------------ * Изменили `поиск документооборотов`_: * теперь в общий список не будут попадать документообороты регистрации бизнеса. Чтобы получить документообороты по данному типу нужно передать параметр ``type = business-registration``; * добавили новый тип документооборота с ФСС — Подтверждение основного вида экономической деятельности (ПОВЭД). Данный тип документооборота можно только получить. Отправить электронную форму ПОВЭД можно только в Экстерне. * Научились распознавать срок ответа на требование из PDF файла требования ФНС. Метод распознавания требования `POST Recognize`_. * Исправили текст сообщений об ошибках отправки черновика (`Send`_) для случаев, когда указан неверный тип контента или некорректный ip-адрес. * Исправили ошибку генерации ответного документа (reply document), у которого нет печатной формы. * В документации добавили статью по работе с методами :ref:`ленты событий `, также описаны :doc:`/specification/статусы ленты событий`. * Добавили новые методы по работе с контентом, см. раздел в swagger `сервис контентов`_: * Реализована работа с большими файлами документов документооборотов: методы позволяют скачивать контент любого размера. * В модели документооборотов, созданных от 02.02.2020, добавлены идентификаторы контентов документов. * В методах по работе с контентами файлов можно передавать только идентификатор контента, например, для печати документа. Январь 2020 ----------- **Обновления в API Контур.Экстерна:** * Добавили уведомления в ленту событий по документооборотам ФСС и ПФР. * Добавили контентам документов описание состояния: сжат, зашифрован, расшифрован и т.д. Ранее описание состояния было только у документа и могло быть некорректным. * Исправили ошибку при создании черновика: для ИП не обязательно заполнение Payer.Organization. **Обновления в Extern Test Tools:** * В методах генерации требований и писем добавили поле ifnsCode, что позволит тестировать получение требований от разных ИФНС. ______ Ранее мы не вели практику написания изменений в API, поэтому обновлений за 2018-2019 год нет.